<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Chapter 3. Testing and Certifying the Port</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Porting Berkeley DB" />
    <link rel="up" href="index.html" title="Porting Berkeley DB" />
    <link rel="prev" href="layout.html" title="Source Code Layout" />
    <link rel="next" href="modifytest.html" title="Modifying the Tests" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.2</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Chapter 3. Testing and Certifying the Port</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="layout.html">Prev</a> </td>
          <th width="60%" align="center"> </th>
          <td width="20%" align="right"> <a accesskey="n" href="modifytest.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="chapter" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title"><a id="testport"></a>Chapter 3. Testing and Certifying the Port</h2>
          </div>
        </div>
      </div>
      <div class="toc">
        <p>
          <b>Table of Contents</b>
        </p>
        <dl>
          <dt>
            <span class="sect1">
              <a href="testport.html#testtypes">Types of Tests for Berkeley DB</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="modifytest.html">Modifying the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="testrun.html">Running the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="testreview.html">Reviewing the Results of the Tests</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="sourceintegrate.html">Integrating Changes into the Berkeley DB Source Code</a>
            </span>
          </dt>
          <dt>
            <span class="sect1">
              <a href="certport.html">Certifying a Port of Berkeley DB</a>
            </span>
          </dt>
        </dl>
      </div>
      <p>
There are several different types of tests available for validating your
port of Berkeley DB as discussed in <a class="xref" href="testport.html#testtypes" title="Types of Tests for Berkeley DB">Types of Tests for Berkeley DB</a>. Testing your port involves:
</p>
      <div class="itemizedlist">
        <ul type="disc">
          <li>
            <p>
<a class="xref" href="modifytest.html" title="Modifying the Tests">Modifying the Tests</a>
</p>
          </li>
          <li>
            <p>
<a class="xref" href="testrun.html" title="Running the Tests">Running the Tests</a>
</p>
          </li>
          <li>
            <p>
        <a class="xref" href="testreview.html" title="Reviewing the Results of the Tests">Reviewing the Results of the Tests</a>
</p>
          </li>
          <li>
            <p>
<a class="xref" href="sourceintegrate.html" title="Integrating Changes into the Berkeley DB Source Code">Integrating Changes into the Berkeley DB Source Code</a>
</p>
          </li>
          <li>
            <p>
        <a class="xref" href="certport.html" title="Certifying a Port of Berkeley DB">Certifying a Port of Berkeley DB</a>
</p>
          </li>
        </ul>
      </div>
      <div class="sect1" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title" style="clear: both"><a id="testtypes"></a>Types of Tests for Berkeley DB</h2>
            </div>
          </div>
        </div>
        <p>
There are two types of tests available for testing your port of Berkeley DB:
</p>
        <div class="itemizedlist">
          <ul type="disc">
            <li>
              <p>The C Tests for Berkeley DB</p>
              <p>
There are two types of C tests for Berkeley DB. Each of these is in its own directory:
</p>
              <div class="itemizedlist">
                <ul type="circle">
                  <li>
                    <p>
The <code class="literal">test_mutex</code> test is found in <code class="literal">src/mutex</code>.
</p>
                  </li>
                  <li>
                    <p>
The <code class="literal">test_micro</code> tests are found in <code class="literal">test/micro</code>.
Here you will find C tests that exercise the most common code paths. However, please note that 
<code class="literal">test_micro</code> is not intended to be an exhaustive test suite. Additionally, it tests the
different versions of Berkeley DB (including the new port) against each
other.  The <code class="literal">test_micro</code> tests can either be run in a shell or as simple C tests.
</p>
                  </li>
                </ul>
              </div>
            </li>
            <li>
              <p>The Berkeley DB Test Suite</p>
              <p>
The <code class="literal">test</code> directory contains the Berkeley DB Test Suite that tests all of the code in Berkeley DB. Using the Test Suite involves using Tool Command Language (Tcl) version 8.5 or later. Running the standard version of the Test Suite executes tests the major functionality of Berkeley DB. A more exhaustive version of the Test Suite runs all the tests several more times, testing encryption, replication, and different page sizes.
</p>
            </li>
          </ul>
        </div>
      </div>
      <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
        <h3 class="title">Note</h3>
        <p>
            Contact the Oracle Berkeley DB engineering team for a platform compatibility test suite.
            
        </p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="layout.html">Prev</a> </td>
          <td width="20%" align="center"> </td>
          <td width="40%" align="right"> <a accesskey="n" href="modifytest.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Source Code Layout </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Modifying the Tests</td>
        </tr>
      </table>
    </div>
  </body>
</html>
